## MITIGATIONS PROVEN UNSAFE. MONITOR #7 FOR UPDATES

## PLEASE DON'T SHARE THIS PROJECT IN PUBLIC. YES, SHARING JUST THE NAME IS "SHARING" TOO

### Regions
Experimental mitigations currently only available for OS

### Information
The Game's anticheat is fundamentally incompatible with Wine in multiple ways (at least 3). This patch removes it entirely and imitates it's behaviour. This is much more radical than classical micropatching, so the risks are probably higher. Please contact me if you want to know how the patch works.

The game also requires DirectX shared resources, which will probably never be fully supported by DXVK/WineD3D. **The patch forces Unity to not use DirectX shared resources in a rather hacky way. This might cause graphical glitches.**

And no, it does not work on Windows.

### Installation

**Wine 8.0+ (staging branch) is recommended to run the Game**. Older Wine versions will probably work as well. [DXVK](https://github.com/doitsujin/dxvk) is recommended, but not required.

~~[The Honkers Railway Launcher](https://github.com/an-anime-team/the-honkers-railway-launcher) can be used to install and patch the Game automatically. If you don't want to use the launcher, follow the manual installation instructions below.~~

~~macOS users: [Yaagl](https://github.com/3Shain/yet-another-anime-game-launcher) can be used to install and patch the Game automatically.~~

Mitigations are currently not supported by any third-party launchers

Manual installation:
- Download and install the Game from the official website. Do not launch the Game
- Clone this repo (not into the game directory!) and switch to the mitigations branch: `git clone https://notabug.org/mkrsym1/astra && git checkout mitigations`
- Open the game directory in your terminal
- Install the patch: `install.sh --patch-data /some/directory`. `/some/directory` is the directory where the patch files will be copied to (**MUST BE OUTSIDE OF THE GAME DIRECTORY. MAY RESULT IN A BAN OTHERWISE**). Use `install.sh --root-cmd <command>` to use something else instead of polkit

Please start the game **ONLY** using `launch.bat`

### Guidelines
1. **Please don't share this project in public.** This might attract unnecessary attention from either the Game Company or the Anticheat Company
2. **Please don't abuse this project for cheating.** We're just trying to play the Game through Wine

### Troubleshooting
Please do not report any issues with the Game to the official channels. Use the issue tracker of this repository

Refer to TROUBLESHOOTING.md for the list of known issues.

### Credits

- mkrsym1 &mdash; project leader, reverse engineering, TVM autoanalysis and metadata generator tool (not public), TVMBootstrap.dll, patches, patch installer
- Yor#1920 - major help with analyzing network activity
- [An Anime Team](https://github.com/an-anime-team) &mdash; [The Honkers Railway Launcher](https://github.com/an-anime-team/the-honkers-railway-launcher), [mirror of this repository](https://codeberg.org/an-anime-team/astra)
- [3Shain](https://github.com/3Shain) &mdash; [Yaagl](https://github.com/3Shain/yet-another-anime-game-launcher), modified Wine for macOS

License: MIT
